Visaの新サービス(Visa Developer)のサンプルコードをObjective−Cに変換してみた。

#iOS

#iPhone

SIN

2016.02.19

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

1 はじめに

今回は、Visaで新しく提供されたWebAPIを試して見るために、サンプルで公開されているコードをObjective−Cに変換して、iPhoneでアクセスしてみました。

2 Visa Developer

Visa（Visa Inc.）は、今年2月初めに、同社の決済処理のプラットフォームを外部の開発者に開放するプログラム「Visa Developer」を公開しました。

ZDNet -Visa opens up its payment network to developers-

このプログラムは、WebAPIとして公開されており、ドキュメントを見ると「Visa Checkout（支払いサービス）」や「Visa Direct（資金移動やスマフォによる支払い）」などの基本的な機能の他にも、 Foreign Exchange Rates(外国為替レート)、ATM Locator(ATM所在地)、Coupon(クーポン)、 Inventory Management(在庫管理)、Sales Policy(販売政策)、Shopping Cart(ショッピングカート)などなど、非常に多岐にわたるサービス（約150種類）を展開しているのが分かります。

Explore our APIs and discover how you can use them

3 スタートアップ

同サービスのGetting Started Guideのページに、このサービスを利用する際のスタート要領が紹介されています。

Getting Started Guide

これによると、概ね次のとおりです。

(1) API検索

トップページにAPIの検索とドキュメントへのリンクがあります。

(2) サンドボックス

同社で提供するサンドボックス（ブラウザインターフェース）でそれをテストできます。

(3) 開発者登録

独自のテストアプリを作成し、WebAPIでアクセスするには、認証コードが必要なため、開発者として登録が必要になります。アカウント作成は、無料であり、好きなAPIを組合わせて任意のアプリを作成し、試験用のWebAPIサーバで試験ができます。

(4) アプリ申請

作成したアプリは、審査が必要です。連絡してレビューを受け、契約、価格設定等の手順へ進みます。

4 認証方法

上記の手順の中で、(3)まで進むと、実際にWebAPIにアクセスする必要がありますが、この時のアクセス時に認証方法として、次の２種類が提供されています。

Using Two-Way SSL (Mutual Authentication)
Using API Key – Shared Secret (X-Pay-Token)

最初の方は、SSLによる相互認証で、２つ目が、API用に発行されたAPIキーとシークレットキーでアクセスする方法です。

SSL相互認証は、クライアント側の証明書の用意が必要なので、今回は、手軽な２番目の方法を試してみました。

２番目の要領は、非常にトリッキーな要領で、APIキーやシークレットキーをリクエストに埋め込むため、サンプルとして、GitHubにコードが公開されています。

https://github.com/VisaDeveloperProgram/SampleCode

しかし、残念ながら、iPhoneでそのまま使える、SwiftやObjective−Cはありません。

5 Objective−Cによるサンプル

できるだけ忠実にサンプルコードをObjective−Cに移植してみました。

- (IBAction)tapButton:(id)sender {

    NSString *baseUri = @"cybersource/";
    NSString *resourcePath = @"payments/v1/authorizations";
    NSString *url = [NSString stringWithFormat:@"https://sandbox.api.visa.com/%@%@?apikey=%@",baseUri,resourcePath,API_KEY];
    NSString *body = @"{\"amount\": \"0\", \"currency\": \"USD\", \"payment\": { \"cardNumber\": \"4111111111111111\", \"cardExpirationMonth\": \"10\", \"cardExpirationYear\": \"2016\" }}";
    NSString *xPayToken = [self getXPayToken:resourcePath queryString:[NSString stringWithFormat:@"apikey=%@",API_KEY] requestBody:body];

    NSMutableURLRequest *request = [[NSMutableURLRequest alloc] init];
    [request setURL:[NSURL URLWithString:url]];
    [request setHTTPMethod:@"POST"];
    [request addValue:@"application/json" forHTTPHeaderField: @"Content-Type"];
    [request addValue:xPayToken forHTTPHeaderField: @"x-pay-token"];
    NSMutableData *postBody = [NSMutableData data];
    [postBody appendData:[body dataUsingEncoding:NSUTF8StringEncoding]];
    [request setHTTPBody:postBody];

    NSURLSession *session = [NSURLSession sharedSession];
    [[session dataTaskWithRequest: request  completionHandler: ^(NSData *data, NSURLResponse *response, NSError *error) {
        if (response && ! error) {
            NSString *responseString = [[NSString alloc] initWithData: data  encoding: NSUTF8StringEncoding];
            NSLog(responseString);
            dispatch_async(dispatch_get_main_queue(), ^{
                self.textView.text = responseString;
            });
        }
        else {
            NSLog(@"ERROR: %@",error);
        }

    }] resume];
}

- (NSString *)getXPayToken:(NSString *)apiNameURI queryString:(NSString *)queryString requestBody:(NSString *)requestBody
{
    NSString *timestamp = [self getTimestamp];
    NSString *sourceString = [NSString stringWithFormat:@"%@%@%@%@%@",SHARED_SECRET,timestamp,apiNameURI,queryString,requestBody];;
    NSString *hash = [self getDigest:sourceString];
    NSString *token = [NSString stringWithFormat:@"x:%@:%@",timestamp,hash];
    return token;
}

- (NSString *)getTimestamp
{
    long timeStamp = (long)[[NSDate date] timeIntervalSince1970];
    return [NSString stringWithFormat : @"%ld", timeStamp];
}

- (NSString *)getDigest:(NSString *)date
{
    NSData *d = [date dataUsingEncoding:NSASCIIStringEncoding];
    uint8_t bytes[64];
    CC_SHA256(d.bytes, d.length, bytes);
    NSMutableString* digest = [NSMutableString stringWithCapacity:64];
    for(int i = 0; i < 32; i++) {
        [digest appendFormat:@"%02x", bytes[i]];
    }
    return digest;
}

サンプルコード(http://github.com/furuya02/CybersourceSample/blob/master/CybersourceSample/ViewController.m)